home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmVaCreateSimpleRadioBox.z / XmVaCreateSimpleRadioBox
Encoding:
Text File  |  2002-10-03  |  9.2 KB  |  199 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx - A RowColumn widget convenience
  10.           creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////RRRRoooowwwwCCCCoooolllluuuummmmnnnn....hhhh>>>>
  14.  
  15.           WWWWiiiiddddggggeeeetttt XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx ((((_p_a_r_e_n_t, _n_a_m_e, _b_u_t_t_o_n__s_e_t, _c_a_l_l_b_a_c_k,
  16.                     _a_r_g...))))
  17.                WWWWiiiiddddggggeeeetttt    _p_a_r_e_n_t;;;;
  18.                SSSSttttrrrriiiinnnngggg    _n_a_m_e;;;;
  19.                iiiinnnntttt       _b_u_t_t_o_n__s_e_t;;;;
  20.                XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc_c_a_l_l_b_a_c_k;;;;
  21.  
  22.  
  23.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  24.           This page documents version 1.2 of the Motif library.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx creates an instance of a RowColumn
  28.           widget of type XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA and returns the associated widget
  29.           ID.  This routine uses the ANSI C variable-length argument
  30.           list (varargs) calling convention.
  31.  
  32.           This routine creates a RadioBox and its ToggleButtonGadget
  33.           children.  The name of each button is button__n, where _n is
  34.           an integer from 0 to one minus the number of buttons in the
  35.           menu.
  36.  
  37.  
  38.           _p_a_r_e_n_t Specifies the parent widget ID.
  39.  
  40.           _n_a_m_e   Specifies the name of the created widget.
  41.  
  42.           _b_u_t_t_o_n__s_e_t
  43.                  Specifies which button is initially set.  The value
  44.                  is the integer _n in the button name button__n.
  45.  
  46.           _c_a_l_l_b_a_c_k
  47.                  Specifies a callback procedure to be called when a
  48.                  button's value changes.  This callback function is
  49.                  added to each button after creation as the button's
  50.                  XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.  The callback function is
  51.                  called when a button's value changes, and the button
  52.                  number is returned in the _c_l_i_e_n_t__d_a_t_a field.
  53.  
  54.  
  55.           The variable portion of the argument list consists of groups
  56.           of arguments.  The first argument in each group is a
  57.           constant or a string and determines which arguments follow
  58.           in that group.  The last argument in the list must be NULL.
  59.           Following are the possible first arguments in each group of
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           varargs:
  75.  
  76.  
  77.           XXXXmmmmVVVVaaaaRRRRAAAADDDDIIIIOOOOBBBBUUUUTTTTTTTTOOOONNNN
  78.                  This is followed by four additional arguments.  The
  79.                  set specifies one button in the RadioBox and some of
  80.                  its resource values.  Following are the additional
  81.                  four arguments, in this order:
  82.  
  83.  
  84.                  _l_a_b_e_l   The label string, of type XmString.
  85.  
  86.                  _m_n_e_m_o_n_i_c
  87.                          The mnemonic, of type KeySym.  This is
  88.                          ignored in this release.
  89.  
  90.                  _a_c_c_e_l_e_r_a_t_o_r
  91.                          The accelerator, of type String.  This is
  92.                          ignored in this release.
  93.  
  94.                  _a_c_c_e_l_e_r_a_t_o_r__t_e_x_t
  95.                          The accelerator text, of type XmString.  This
  96.                          is ignored in this release.
  97.  
  98.  
  99.           _r_e_s_o_u_r_c_e__n_a_m_e
  100.                  This is followed by one additional argument, the
  101.                  value of the resource, of type XtArgVal.  The pair
  102.                  specifies a resource and its value for the RowColumn
  103.                  widget.
  104.  
  105.           XXXXttttVVVVaaaaTTTTyyyyppppeeeeddddAAAArrrrgggg
  106.                  This is followed by four additional arguments.  The
  107.                  set specifies a resource and its value for the
  108.                  RowColumn widget.  A resource type conversion is
  109.                  performed if necessary.  Following are the additional
  110.                  four arguments, in this order:
  111.  
  112.  
  113.                  _n_a_m_e    The resource name, of type String.
  114.  
  115.                  _t_y_p_e    The type of the resource value supplied, of
  116.                          type String.
  117.  
  118.                  _v_a_l_u_e   The resource value (or a pointer to the
  119.                          resource value, depending on the type and
  120.                          size of the value), of type XtArgVal.
  121.  
  122.                  _s_i_z_e    The size of the resource value in bytes, of
  123.                          type int.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           XXXXttttVVVVaaaaNNNNeeeesssstttteeeeddddLLLLiiiisssstttt
  141.                  This is followed by one additional argument of type
  142.                  XtVarArgsList.  This argument is a nested list of
  143.                  varargs returned by XXXXttttVVVVaaaaCCCCrrrreeeeaaaatttteeeeAAAArrrrggggssssLLLLiiiisssstttt.
  144.  
  145.  
  146.           For more information on variable-length argument lists, see
  147.           the X Toolkit Intrinsics documentation.
  148.  
  149.           A number of resources exist specifically for use with this
  150.           and other simple menu creation routines.  For a complete
  151.           definition of RowColumn and its associated resources, see
  152.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))).
  153.  
  154.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  155.           Returns the RowColumn widget ID.
  156.  
  157.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  158.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))),
  159.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX)))),
  160.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))), and XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX)))),
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.